All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class quicktime.util.QTHandle

java.lang.Object
   |
   +----quicktime.QTObject
           |
           +----quicktime.util.QTHandleRef
                   |
                   +----quicktime.util.QTHandle

public class QTHandle

extends QTHandleRef

implements QuickTimeLib

QTHandle()

Allocate a handle of minimum size for general use.

QTHandle(byte[])

Construct a handle from input data.

QTHandle(int, boolean)

Allocate a handle for general use.

QTHandle(QTHandleRef, QTHandleRef)

Construct a handle from the concatenation of the two handles supplied.

QTHandle(QTPointerRef, int, int)

This constructor is used to create a QTHandle object from a QTPointer.

clone()

Implementation of Cloneable Interface.

concatenate(QTHandleRef)

Concatenates the supplied handle to this handle, resize the size of this handle to accomodate the second handle's data.

fromEncodedImage(EncodedImage)

Returns EncodedImage data as a QTHandle.

fromGraphicsImporterAlias(GraphicsImporter)

Determines the aliased data reference.

fromGraphicsImporterData(GraphicsImporter)

Determines the data reference that the graphics resides in.

fromSoundDescription(SoundDescription, int)

Retrieve application specific info from a Sound Description object

QuickTime::GetSoundDescriptionExtension

fromTimeCoderCurrent(TimeCoder)

Determines the time code from the time code handler at the current time value.

fromTimeCoderSource(TimeCoder, TimeCodeDescription)

Allows you to retrieve the source information from the time code media sample.

fromTimeCoderTime(TimeCoder, int)

Determines the time code from the time code handler.

fromTrack(Track)

This method returns the sound localization settings for the track.

reserveMemory(int)

Use reserve memory before you allocate a handle that you intend to keep locked for long periods of time.

setSize(int)

Resizes the handle to the specified size.

 public QTHandle() throws QTException

Allocate a handle of minimum size for general use.

Parameters:

size - the size of the handle to create.

clear - clear the handle upon creation.

 public QTHandle(int size,
                 boolean clear) throws QTException

Allocate a handle for general use.

QuickTime::NewHandle QuickTime::NewHandle



QuickTime::NewHandleClear QuickTime::NewHandleClear

Parameters:

size - the size of the handle to create.

clear - clear the handle upon creation.

 public QTHandle(byte byteArray[]) throws QTException

Construct a handle from input data.

Parameters:

byteArray - the input data.

 public QTHandle(QTPointerRef ptr,
                 int offset,
                 int size) throws QTException

This constructor is used to create a QTHandle object from a QTPointer. The contents of the pointer will be copied into the handle. This will copy size bytes from the pointer + offset. It will bounds check the size to be not greater than the size of the pointer.

QuickTime::PtrToHand

Parameters:

ptr - the pointer to copy.

offset - you can specify an offset within the pointer from which to copy the data

size - the amount of bytes to copy

 public QTHandle(QTHandleRef firstHandle,
                 QTHandleRef secondHandle) throws QTException

Construct a handle from the concatenation of the two handles supplied. The First handle will appear first in the concatentated result.

Parameters:

firstHandle - the first Handle

secondHandle - the second Handle

 public static QTHandle fromSoundDescription(SoundDescription sd,
                                             int idType) throws QTException

Retrieve application specific info from a Sound Description object

QuickTime::GetSoundDescriptionExtension

Parameters:

idType - an OSType identifying the information for removal

Returns:

a dataref to the Extension

See Also:

getExtension

 public static QTHandle fromGraphicsImporterData(GraphicsImporter gi) throws QTException

Determines the data reference that the graphics resides in.

QuickTime::GraphicsImportGetDataHandle

Returns:

The handle to a QuickTime data reference.

See Also:

getDataHandle

 public static QTHandle fromGraphicsImporterAlias(GraphicsImporter gi) throws QTException

Determines the aliased data reference.

QuickTime::GraphicsImportGetAliasedDataReference

Returns:

The handle to the aliased data reference

See Also:

getAliasedDataReference

 public static TimeCodeInfo fromTimeCoderTime(TimeCoder tc,
                                              int mediaTime) throws QTException

Determines the time code from the time code handler.

QuickTime::TCGetTimeCodeAtTime()

Parameters:

mediaTime - The time value of the media at which to retrieve the time code information.

Returns:

The information object containing the time code, its definition, and data.

See Also:

getAtTime

 public static TimeCodeInfo fromTimeCoderCurrent(TimeCoder tc) throws QTException

Determines the time code from the time code handler at the current time value.

QuickTime::TCGetCurrentTimeCode()

Returns:

The information object containing the time code, its definition, and data.

See Also:

getCurrent

 public static QTHandle fromTimeCoderSource(TimeCoder tc,
                                            TimeCodeDescription tcd) throws QTException

Allows you to retrieve the source information from the time code media sample.

QuickTime::TCGetSourceRef()

Parameters:

tcd - the description that describes the time code reference to be changed

Returns:

the source information that is found in the sample reference

See Also:

getSourceRef

 public static QTHandle fromTrack(Track t) throws QTException

This method returns the sound localization settings for the track.

QuickTime::GetTrackSoundLocalizationSettings()

Returns:

the sound localization settings for the track.

See Also:

getSoundLocalizationSettings

 public static QTHandle fromEncodedImage(EncodedImage image) throws QTException

Returns EncodedImage data as a QTHandle. This will copy the data.

Parameters:

image - the encoded image data

Returns:

the encoded image data as a Handle

 public static void reserveMemory(int size) throws UtilException

Use reserve memory before you allocate a handle that you intend to keep locked for long periods of time.

QuickTime::ReserveMem QuickTime::ReserveMem

Parameters:

size - the size of the handle you will allocate in the new Handle(size...) call

 public void setSize(int size) throws UtilException

Resizes the handle to the specified size.

QuickTime::SetHandleSize

Parameters:

size - the new size of the handle.

 public void concatenate(QTHandleRef hand) throws UtilException

Concatenates the supplied handle to this handle, resize the size of this handle to accomodate the second handle's data. Subclasses should overide this is a straight concatenation of the two handles are insufficient to preserve state.

QuickTime::HandAndHand

 public Object clone()

Implementation of Cloneable Interface.

Overrides:

clone in class Object

All Packages  Class Hierarchy  This Package  Previous  Next  Index